home *** CD-ROM | disk | FTP | other *** search
/ NeXT Education Software Sampler 1992 Fall / NeXT Education Software Sampler 1992 Fall.iso / READMEFiles / Patchmix.README < prev    next >
Text File  |  1992-08-29  |  5KB  |  85 lines
  1. Patchmix by Mara Helmuth
  2.     
  3. email:     mara@woof.music.columbia.edu
  4.         mara@silvertone.princeton.edu
  5. US mail: 709 Dodge Hall, Columbia University, New York, NY 10025
  6.  
  7. category: Music
  8.     
  9. Patchmix  is a graphical interface to the Cmix Programming Language.  
  10. Within it, you can create and test Cmix instruments by constructing 
  11. a flow chart of unit generator icons.  
  12.  
  13. Patchmix is used for teaching Cmix, signal processing and C programming 
  14. in the Computer Music class at Columbia University.
  15.  
  16. It was developed under NeXTstep Release 2.1.
  17.  
  18. Cmix must be installed.  Be sure to put the correct directories in the file information window.
  19.  
  20. Description:
  21.  
  22.                          What is Patchmix?
  23. Patchmix  is a graphical interface to the Cmix Programming 
  24. Language.  Within it, you can create and test Cmix instruments.  
  25. Since the code for the instrument is written out to a specified directory, 
  26. you can then work with this code later and modify it as you wish.  
  27. Patchmix can be helpful either to someone learning Cmix or to put together 
  28. quickly instruments which could then be altered as necessary.  To run it, you 
  29. need Cmix installed in the directory specified in your file  information window. 
  30.     To get started, first make sure you have correct file info in the panel. 
  31. Then, drag unit generators from the palette window onto the white patch view.  
  32. Double-click on any unwanted unit generators to remove them.  To set 
  33. parameters for their inputs, double click on the parameter knob and 
  34. set the value in the top right param field.  Then, connect the unit 
  35. generators, outputs to inputs, by dragging the mouse from output to input.  
  36. Redrawing will erase them.   When you're done making a patch, write out 
  37. a score from the test score panel, being sure to fill in any designated 
  38. parameter fields if you used them in the input parameters (i.e. p[3] could be 
  39. frequency input to an oscillator).   Then, you're ready to test it out.
  40. Write out a score file from the Score Data Window.  Hit the "write code", 
  41. "compile", "run", "rescale" and "play" buttons.  To make sure each 
  42. process has finished before starting the next, watch the "display output" window.
  43. Send any bugs, suggestions or comments to mara@woof.music.columbia.edu.
  44.  
  45.                            Main Window
  46. The main window is where the flow chart is constructed, and where you select instrument-
  47. building functions with the compile, play or run buttons.  Also,  the name of your instrument
  48. and the directory where you want the code to be written should be specified in the form fields.
  49. To the right, the "param" field holds values you want to store as inputs to the unit generators.
  50.  
  51.                            Panel Buttons
  52. reset will clear the flow chart off the screen (except for the output unit generator).
  53.     This is an irreversible procedure.
  54. write code will write out the Cmix code into the "Newinst" directory, under filenames
  55.     "inst1.c", Makefile and profile.c.  If you already have these files in this directory
  56.     they will be overwritten.  If you specify different file names in the main window,
  57.     they will be used. 
  58. compile will compile the new instrument program.
  59. run creates the sound file by running the Cmix program.
  60. rescale will rescale the sound file from a floating point to an integer sound file.
  61. play will play the sound file.
  62. compile will  compile the instrument that has been written out.
  63. run will run the cmix job using the instrument specified in the main window, and the
  64.     score file and sound file specified in the file information window.
  65. rescale will rescale the soundfile into a playable integer file.
  66. play will play the soundfile.
  67.  
  68. Warning:  Loops in the patch will not work. 
  69.  
  70.                         Cmix Unit Generators
  71. The unit generator panel contains in the first row  an oscilator, buzz, random number
  72. generator, evp (simple envelope with attack and decay) and a reson filter.  The
  73. second and fourth rows are not yet working.   The third row contains addition, subtraction
  74. multiplication and division operators.  The six items in the right-most column are pitch
  75. converters.  "pch" means octave.pitch class representation, "oct" means octave.decimal,
  76. and "cps" means Hertz or cycles per second.  So, "pchcps" converts from Hz to octave.
  77. pitch class notation.  The Cmix man pages explain more about these unit generators.
  78.  
  79. The input values to each parameter or argument of the unit generator may be set internally
  80. by Patchmix, or more often can be set by the user in the "Param" field at the top of the main
  81. window.  If the value is something that should be determined by the data or score file
  82. and not specified in the instrument, enter a new p-field number in the Param field when this
  83. input is selected.  For example, in a one-oscil instrument, perhaps frequency should be a 
  84. p-field.  Go to the Score Data window and choose an unused p-field (i.e. p[3]) and enter
  85. it into the frequency param.  Then pitch will be determined in the score for this instrument.